home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / flushband.z / flushband
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  132 lines
  1.  
  2.  
  3.  
  4. fffflllluuuusssshhhhbbbbaaaannnndddd((((DDDD3333))))                                                    fffflllluuuusssshhhhbbbbaaaannnndddd((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ffff_llll_uuuu_ssss_hhhh_bbbb_aaaa_nnnn_dddd - flush messages in a specified priority band
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _vvvv_oooo_iiii_dddd _ffff_llll_uuuu_ssss_hhhh_bbbb_aaaa_nnnn_dddd_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _uuuu_cccc_hhhh_aaaa_rrrr______tttt _p_r_i_,,,, _iiii_nnnn_tttt _f_l_a_g_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _q    Pointer to the queue.
  19.  
  20.      _p_r_i  Priority band of messages to be flushed.
  21.  
  22.      _f_l_a_g Determines messages to flush.
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      The _ffff_llll_uuuu_ssss_hhhh_bbbb_aaaa_nnnn_dddd function flushes messages associated with the priority band
  26.      specified by _p_r_i.  If _p_r_i is _0000, only normal and high priority messages
  27.      are flushed.  Otherwise, messages are flushed from the band _p_r_i according
  28.      to the value of _f_l_a_g.
  29.  
  30.      If the band's count falls below the low water mark and someone wants to
  31.      write to the band, the nearest upstream or downstream service procedure
  32.      is enabled.
  33.  
  34.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  35.      None
  36.  
  37. UUUUSSSSAAAAGGGGEEEE
  38.      Valid values for _f_l_a_g are:
  39.  
  40.           _FFFF_LLLL_UUUU_SSSS_HHHH_DDDD_AAAA_TTTT_AAAA      Flush only data messages (types _MMMM______DDDD_AAAA_TTTT_AAAA, _MMMM______DDDD_EEEE_LLLL_AAAA_YYYY,
  41.                          _MMMM______PPPP_RRRR_OOOO_TTTT_OOOO, and _MMMM______PPPP_CCCC_PPPP_RRRR_OOOO_TTTT_OOOO).
  42.  
  43.           _FFFF_LLLL_UUUU_SSSS_HHHH_AAAA_LLLL_LLLL       Flush all messages.
  44.  
  45.    LLLLeeeevvvveeeellll
  46.      Base or Interrupt.
  47.  
  48.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  49.      Does not sleep.
  50.  
  51.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  52.      across calls to this function.
  53.  
  54.    EEEExxxxaaaammmmpppplllleeeessss
  55.      See _pppp_uuuu_tttt(D2) for an example of _ffff_llll_uuuu_ssss_hhhh_bbbb_aaaa_nnnn_dddd.
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. fffflllluuuusssshhhhbbbbaaaannnndddd((((DDDD3333))))                                                    fffflllluuuusssshhhhbbbbaaaannnndddd((((DDDD3333))))
  70.  
  71.  
  72.  
  73. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  74.      _ffff_llll_uuuu_ssss_hhhh_qqqq(D3), _pppp_uuuu_tttt(D2), _qqqq_uuuu_eeee_uuuu_eeee(D4)
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.